Installation
Once you have a new K8s Cluster created as per the guidelines provided in the Cluster Requirements doc, installing any StackGen stack can be done using the following steps:
First Time Installation
Download Config Generator
Download the config generator:
# Linux AMD64
https://opsverse-public.s3.amazonaws.com/self-host/LATEST/opsverse-config-generator-linux-amd64
# Linux ARM64
https://opsverse-public.s3.amazonaws.com/self-host/LATEST/opsverse-config-generator-linux-arm64
# OSX AMD64
https://opsverse-public.s3.amazonaws.com/self-host/LATEST/opsverse-config-generator-darwin-amd64
# OSX ARM64
https://opsverse-public.s3.amazonaws.com/self-host/LATEST/opsverse-config-generator-darwin-arm64
# Windows AMD64
https://opsverse-public.s3.amazonaws.com/self-host/LATEST/opsverse-config-generator-windows-amd64.exe
Run the Config Generator
Run the following command and follow instructions on your screen
./opsverse-config-generator-<os>-<architecture>
At the end of the process, you will be presented with two values.yaml files, which will be preconfigured with all the base configurations required for installing your StackGen stack
Save this values.yaml file since it will contain all the configuration for your StackGen stack and will be required when you want to update components/versions or upgrade ObserveNow components. It can also be committed to git if you want to follow a GitOps workflow
Install the Operators
Install the operators required for your stack by running the following helm install against your cluster with one of the config files generated in the previous step.
helm upgrade --install operators-now -n observe --create-namespace opsverse-operators --repo https://<username>:<password>@registry.devopsnow.io/chartrepo/internal -f operator-values.yaml
Make sure to replace username/password above with the credentials you have received from your StackGen Onboarding Representative
Install the Stack
Installing your StackGen stack is now simply a matter of running helm install against your cluster with the other config file generated in the previous step.
helm upgrade --install <custname>-<stackname> -n observe --create-namespace opsverse-onow --repo https://<username>:<password>@registry.devopsnow.io/chartrepo/internal -f values.yaml
Make sure to replace username/password above with the credentials you have received from your StackGen Onboarding Representative
That's it! If you look at your cluster, you should see StackGen components coming up. Give it a few minutes to ensure all pods are up and running.
Add DNS Entries
The helm command should also give a list of ingresses created that need to be added to your DNS service (eg. Route53 ). You can also run kubectl get ingress -A to get a list of ingresses along with the address to use for your DNS service.
Once you add your ingresses to DNS and let DNS propogate, you should be able to access different components of your StackGen stack from your browser.
Make sure your Certificate ACM ARN is correct in the config, otherwise your HTTPS endpoints may fail with a certificate error.
Making Updates
Since everything is driven by helm charts, making updates is as simple as updating the values.yaml file you had created in the previous steps and re-running the helm install command again. Charts can also be updated using helm repo update command to ensure you are always running the latest chart version. Make sure to look at the compatibility and deprecations in new chart versions to ensure you don't end up pushing breaking changes to your StackGen stack.